home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3x / curs_getstr.z / curs_getstr
Encoding:
Text File  |  2002-10-03  |  4.4 KB  |  65 lines
  1.  
  2.  
  3.  
  4. ccccuuuurrrrssss____ggggeeeettttssssttttrrrr((((3333XXXX))))                                                ccccuuuurrrrssss____ggggeeeettttssssttttrrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_uuuu_rrrr_ssss______gggg_eeee_tttt_ssss_tttt_rrrr:  _gggg_eeee_tttt_ssss_tttt_rrrr, _wwww_gggg_eeee_tttt_ssss_tttt_rrrr, _mmmm_vvvv_gggg_eeee_tttt_ssss_tttt_rrrr, _mmmm_vvvv_wwww_gggg_eeee_tttt_ssss_tttt_rrrr, _wwww_gggg_eeee_tttt_nnnn_ssss_tttt_rrrr - get
  10.      character strings from _cccc_uuuu_rrrr_ssss_eeee_ssss terminal keyboard
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh_>>>>
  14.  
  15.      _iiii_nnnn_tttt _gggg_eeee_tttt_ssss_tttt_rrrr_((((_cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_))))_;;;;
  16.      _iiii_nnnn_tttt _wwww_gggg_eeee_tttt_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_))))_;;;;
  17.      _iiii_nnnn_tttt _mmmm_vvvv_gggg_eeee_tttt_ssss_tttt_rrrr_((((_iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_))))_;;;;
  18.      _iiii_nnnn_tttt _mmmm_vvvv_wwww_gggg_eeee_tttt_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_))))_;;;;
  19.      _iiii_nnnn_tttt _wwww_gggg_eeee_tttt_nnnn_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The effect of _gggg_eeee_tttt_ssss_tttt_rrrr is as though a series of calls to _gggg_eeee_tttt_cccc_hhhh were made,
  23.      until a newline and carriage return is received.  The resulting value is
  24.      placed in the area pointed to by the character pointer _s_t_r.  _wwww_gggg_eeee_tttt_nnnn_ssss_tttt_rrrr
  25.      reads at most _n characters, thus preventing a possible overflow of the
  26.      input buffer.  The user's erase and kill characters are interpreted, as
  27.      well as any special keys (such as function keys, ``home'' key, ``clear''
  28.      key, and so on).
  29.  
  30. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  31.      All routines return the integer _EEEE_RRRR_RRRR upon failure and an integer value
  32.      other than _EEEE_RRRR_RRRR upon successful completion.
  33.  
  34. NNNNOOOOTTTTEEEESSSS
  35.      The header file _cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh automatically includes the header files _ssss_tttt_dddd_iiii_oooo_...._hhhh
  36.      and _uuuu_nnnn_cccc_tttt_rrrr_llll_...._hhhh.
  37.  
  38.      Note that _gggg_eeee_tttt_ssss_tttt_rrrr, _mmmm_vvvv_gggg_eeee_tttt_ssss_tttt_rrrr, and _mmmm_vvvv_wwww_gggg_eeee_tttt_ssss_tttt_rrrr may be macros.
  39.  
  40. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  41.      _cccc_uuuu_rrrr_ssss_eeee_ssss(3X), _cccc_uuuu_rrrr_ssss______gggg_eeee_tttt_cccc_hhhh(3X)
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                                                         PPPPaaaaggggeeee 1111
  62.  
  63.  
  64.  
  65.